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ABSTRACT 


EZPLOT is a computer applications program that converts data resident on a file into a plot displayed on the 
screen of a graphics terminal. This program generates either time history or x-y plots in response to commands 
entered interactively from a terminal keyboard. Plot parameters consist of a single independent parameter and 
from one to eight dependent parameters. Various line patterns, symbol shapes, axis scales, text labels, and data 
modification techniques are available. This user’s manual describes EZPLOT as it is implemented on the Ames 
Research Center, Dryden Flight Research Facility ELXSI computer using DI-3000 graphics software tools. 


INTRODUCTION 

Hight test and other data can be analyzed more quickly and conveniently when plotted data are displayed on 
the screen of a graphics terminal rather than hand drawn on graph paper. This screen-display capability requires 
that a computer program be used to convert data read from a disk file into a plot on a graphics terminal. EZPLOT 
is an interactive computer applications program written at NASA Ames Research Center, Dryden Flight Researc 
Facility (Ames-Dryden), to fulfill this requirement. 

This user’s manual describes the program’s capabilities and how they may be used. This description includes 
features that may be unique to the Ames-Drydcn implementation of EZPLOT on the ELXSI computer (ELXSI , an 
Jose, California) using EMBOS, the ELXSI message-based operating system (ref. 1). A user at another location or 
with another computer may have to modify the program to account for these system-dependent features. 

This manual reflects EZPLOT Version 5.5. Subsequent versions may be reflected in updates to, or new releases 
of, this manual. 


PROGRAM OVERVIEW 


Program Structure 

EZPLOT is a modular FORTRAN program that calls subroutines from the DI-3000 (Precision Visuals, Inc., 
Boulder, Colorado) graphics software library (ref. 2) and from GetData, a utility program for manipulating files of 
time history data (ref. 3). The main EZPLOT program and all applicable EZPLOT, DI-3000, and GetData subrou- 
tines and functions are compiled and bound Oinked) to form an executable module. This module is then used inter- 
actively to generate time history and x-y data plots in response to commands and other information entered from a 
terminal keyboard. 

EZPLOT may also be executed in a noninteractive mode called "batch." On the ELXSI computer, an EZPLOT 
batch job runs independently from any keyboard input. Commands and other inputs are read from a file. This mode 
of execution is described in the Redirection and Batch Operation section. 


Files and Parameters 

Data to be plotted are read from data input files during program execution. A file is a collection of data values 
residing on a computer storage device such as a disk or a tape. All files are identified to EZPLOT by a file name, 
which must follow the file-naming conventions of the hosi operating system. A parameter is a subset of the data 
values in a file and is identified to EZPLOT by an alphanumeric label called a parameter name or ID. Files and 
parameters are discussed further in the Data Input Files and File and Parameter Names sections. 



The program plots one dependent parameter as a function of one independent parameter using data from as 
many as eight files. The program also plots as many as eight dependent parameters as functions of one independent 
parameter using data from one file. A maximum of 10,000 data values for each parameter may be plotted. This limit 
may be changed with a simple modification to the FORTRAN code. 

Plot Features 


This section briefly describes some of the general plot features. All plot features are discussed in detail in the 
Plot Commands section. 

Figures 1 to 5 are representative of plots drawn by the EZPLOT program. The format of these plots may be 
easily modified to meet many analysis and reporting requirements. In some cases, copies of the screen display may 
be used as figures in technical reports. 

Axes and scales. — A plot always consists of one independent parameter and from one to eight dependent pa- 
rameters. Data are plotted on the screen relative to a set of orthogonal axes oriented with the independent param- 
eter along the horizontal x axis and the dependent parameter or parameters along the vertical y axis. Each axis is 
divided into intervals by tick marks. By default, a plot is drawn with 10 intervals along the x axis and 8 intervals 
along the y axis, as illustrated in figure 1 . 

Scales may be linear or logarithmic, as illustrated in figure 2. Default scales are linear and are calculated auto- 
matically to fit all the data available for each plotted parameter. These default scales and the number of intervals may 
be overridden on any axis. If an axis is rescaled, data falling outside the new scale limits are not plotted. The number 
of intervals along a logarithmic scale is automatically adjusted to fit the minimum and maximum scale values. 

A single common y axis and scale may be used for all dependent parameters, or a separate y axis and scale may 
be drawn for each dependent parameter. When separate y axes are used, there are two intervals for each parameter 
and the y axes scales are linear. Multiple y axes arc illustrated in figure 3. 

Plots without multiple y axes may display a background grid consisting of solid or dotted rectilinear lines aligned 
with the tick marks on the axes. A grid using dotted lines is illustrated in figure 1. 

Lines and symbols — The plotted data points may be connected with lines, marked with symbols, or both. If 
both lines and symbols are drawn, the lines are solid. If lines are drawn without symbols, the lines are dashed. Eight 
line patterns and eight symbol shapes arc available. By default, their order of introduction follows that suggested in 
the NASA Publications Manual 1974 (ref. 4). This order may be overridden, if desired. Line patterns are illustrated 
in figure 1 and symbol shapes in figure 4. 

Labels and legends. — By default, the x axis is labeled with the name of the independent parameter. If there 
is one dependent parameter, the y axis is labeled with the parameter name. If there are two or more dependent 
parameters, the y axis is not labeled. Instead, the parameter names are put in a legend. In addition to these labels, 
the tick marks along each axis are labeled with numbers representing the value of that location on the axis. Each 
plot may also have a title at the top, a figure description at the bottom, and up to nine optional lines of text placed 
anywhere on the plot. The text and the size of the characters in any of these labels may be changed. All letters are 
drawn in uppercase. 

Data modification.— Before a plot is drawn, the data may be scaled, translated, thinned, or sorted. As a 
form of wild-point editing, plotted points may be deleted or replaced. Previously deleted or replaced points may 
be reinserted. 

Curve fitting — A single dependent parameter may be fitted with up to a ninth-order least-squares polynomial 
curve. A second-order curve fit is illustrated in figure 5. Some statistical characteristics of the data and the fit may 
be displayed. 
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PROGRAM OPERATION 

Terminal Type 

EZPLOT can be run from a Tektronix 4014, 4 1 14, 4 1 07, or 4 109, a VT125, or any other terminal that can emulate 
a VT100 (Digital Equipment Corp., Maynard, Massachusetts) and a Tektronix 4014 (Tektronic, Inc., Beaverton, 
Oregon). The terminal must be able to display both the text and the graphics planes simultaneously. The terminal 
type must be specified so that the correct plotting escape codes and DI-3000 device driver can be used. On the ELXSI, 
this specification is made through the EZPLOT shellfile (see app. A and ref. 1). Product addresses for Selanar, 
GraphOn, and Modgraph terminals are as follows: Selanar Corp., Santa Clara, California; GraphOn, Campbell, 
California; and Modgraph, Inc., Waltham, Massachusetts. 

An ELXSI plotting session is begun by typing the command ezplot which tells the operating system to execute 
the EZPLOT shellfile. The shellfile responds with an invitatic n to select a graphics terminal type from a menu similar 
to the following: 


EZPLOT Version 5.5 

Friday, December 21, 1987 08:41:27 AM PST 

The following terminals are supported 

(T)ektronix 4014/4114 
(G) raphon 
(S) elanar 
(M) odgraph 
(4)109 Tektronix 
(V) T125 

Enter your terminal type, or "Q" to qiit: (T/G/S/M/4/V/Q) 


The expected response to this prompt is one of the single characters listed in parentheses followed by a carnage return. 
A Q causes the session to end immediately. A character other than Q is used by the shellfile to select the executable 
module containing the relevant DI-3000 device driver for loading. Also, a single word identifying the terminal type 
is assigned to a parameter called a shell variable. This shell variable is later accessed by the program through a call 
to the system-dependent subroutine $VAR (ref. 1) where the identifying word is assigned to a FORTRAN variable. 
This FORTRAN variable is used by the program to select tire plotting escape codes that match the terminial. The 
only other meaningful response to this prompt is the phrase no commands. See the Redirection and Batch Operation 
section for further explanation of this response. 

All EZPLOT input is case insensitive on machines supporting uppercase and lowercase. The commands can be 
entered in any mix of uppercase and lowercase. 

Standard Commands 

After the terminal type is specified, the EZPLOT shellfile passes control to the FORTRAN code. From this point 
on, the following standard commands may be used in response to any prompt where their meaning is appropriate. 
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If a particular command is not appropriate in a given context, the program responds with an informative message 
followed by the same prompt. Each standard command is entered on a line by itself and is followed by a carriage 
return. Standard commands are described in the following tabulation: 


Command 

Meaning 

Description 

<retum> 

Select default 

A carriage return with no other entry causes a de- 
fault value to be selected; defaults, where permit- 
ted, are identified with Default = as part of the 
prompt 


Terminate input 

A period terminates a series of prompts for infor- 
mation such as file names, parameter names, or 
data values; if the prompt is the first in a series, a 
period causes the previous prompt to be displayed 

? 

Help 

A question mark causes a list of choices or other 
helpful information to be displayed 

QU 

End the program 

QU causes program execution to end immedi- 
ately. Control is returned to the EZPLOT shellfile 

DO cmd 

Execute cmd 

DO cmd causes the host operating system com- 
mand cmd to be executed during a session from 
within EZPLOT 


The DO cmd command uses system-dependent features that may have to be modified for other host operating 
systems (refer to the PROGRAM TRANSMITTAL AND IMPLEMENTATION section). 

Data Input Files 

The next prompt following that for terminal type is for selection of data input format. EZPLOT recognizes two 
formats for data input files. These formats are called flight data and generic data. Data input format is selected in 
response to a menu that looks like the following: 

Choose from the following: 

F = Plot FLIGHT data 
G = Plot GENERIC data 

I = INPUT Generic data from the keyboard 
U = View Ezplot USERS GUIDE 

Your choice? (F/G/I/U) 

At Ames-Dryden, flight data exist as a series of binary records on files generated by flight test data reduction computer 
programs. These data are in a time history format that can be read by the GetData program (ref. 3). Each record 
contains values for several (sometimes hundreds of) parameters measured at essentially the same time. The number 
of records on a file is a function of the data interval start and stop times and sampling rate. 

Generic data is in a flexible and generalized format consisting only of ASCII records and may be read from 
existing files or may be entered from the keyboard. The generic data format is described in appendix A. 

Data for up to a maximum of 2000 parameters may be read from input files. 

This menu also provides the option to view the on-line EZPLOT USERS GUIDE. The on-line user’s guide 
contains information similar to that contained in this user’s manual, but in abbreviated form. 
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File and Parameter Names 


The method of file and parameter selection is the same : or both flight and generic data. After data input format 
is selected, the program prompts for the names of the files containing the data and the names of the parameters to 
be plotted. Any default names are given in parentheses after each prompt. The name of the first data input file is 
entered in response to the following prompt: 

Input File 1? 

Data for one plot may be read from as many as eight different data input files. Their names are entered in response 
to a series of prompts similar to that for the first file. If fewer than eight names are entered, the series of prompts 
is terminated with a period (refer to the Standard Commands section). A verification prompt is provided in case an 
error was made while entering file names. 

File names may be any valid ELXSI pathname and ma> include patterns (ref. 1). Wild card features of patterns 
may not be used to select more than one file during any one series of prompts. If desired, a list of file names may 
be entered by typing read [ listfile ] at the prompt for the first data input file. The string [listfile) is replaced with the 
name of a separate file containing the names of the data inp it files. These names must be placed in [ listfile ] prior to 
the start of an EZPLOT session. 

Regardless of how they were entered* the names of the data input files may be saved on a separate file for 
convenience when the data from the same files are to be plotted again. This is done by typing write [listfile] at the 
point where the program asks for verification of the list of data input files, [listfile] is the name of the separate file 
receiving the names. This action implicitly answers yes to the verification prompt. 

After the data input file names have been entered, the pro gram prompts for the name of the independent parameter 
as follows: 

Independent parameter (X)? 

The independent parameter and at least one dependent parameter must be specified before a plot can be drawn. The 
prompt for the name of the first dependent parameter is as follows: 

Dependent parameter 1 (Yl)? 

If only one data input file name was entered, as many as e ight different parameters from that file may be plotted. 
Their names are entered in response to a series of prompts similar to that for the first dependent parameter. If fewer 
than eight names arc entered, the series of prompts is temunated with a period (refer to the Standard Commands 
section). A verification prompt is provided in case an error was made while entering parameter names. 

If more than one data input file name was entered, only one dependent parameter may be plotted. In this case, 
both the independent and the dependent parameter must be present on all the files. 

The names of the parameters available for plotting may be displayed by entering a question mark in response 
to the prompt for independent or dependent parameter names. The program "remembers parameters previously 
entered and displays their names as defaults for easy resele ;tion if desired. 

All of the characters in the name of an available parameter do not need to be entered to select that parameter. 
The program first tries to match the entered name exactly with the name of one of the available parameters. Leading 
and embedded blanks are significant. If an exact match is not successful, the program then attempts to match only 
as many characters as were entered with the same number of characters in one of the available names. This match 
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is always anchored at the left-most character. For example, if the entered name is abc and two available names are 
abed and dabc, there is no exact match. However, abc does match the first three characters of abcd\ therefore, abed 
is selected. Parameter dabc is not selected. If the list of available parameters contains two or more names that match 
the entered name, the first name that matches is selected. 

Plot Commands 

After the names of the data input file or files and the independent and dependent parameters have been entered, 
the program prompts for a plot command as follows: 

COMMAND? 

A plot command is a two-character string that directs the program to take some type of action. Possible actions are to 
draw the plot, to prompt for further entry, to toggle an option on or off, to modify the input data or the characteristics 
of the plot, to display helpful information, and to quit the program. 

Many plot commands display brief messages that describe the progress of program execution or suggest some 
appropriate action. These messages are largely self-explanatory and are not included in this manual. Messages 
generated because of an error or other unusual condition are explained in the Error and Warning Messages section. 

A list of all plot commands along with a brief description of the action the program takes in response to each 
command may be viewed interactively by entering a question mark instead of a command. Similar lists are given 
below. Basic commands are those commands necessary to produce plots under a reasonable amount of control 
without requiring a detailed knowledge of the program. Extended commands provide more complex and flexible 
control over the plot along with several ways to manipulate the input data prior to plotting. Text commands provide 
a way to place explanatory data anywhere on the plot. The second character of each text command is an integer line 
number in the range of 1 to 9. 

Any plot command may be entered when the COMMAND ? prompt is displayed. 

Basic commands are described in the following tabulation: 


Name 

Meaning 

Action 

FI 

Figure 

Prompts for plot figure label 

LE 

Legend 

Turns line and symbol legend on or off 

LI 

Lines 

Turns point-connecting lines on or off 

LL 

Legend label 

Prompts for legend labels 

ME 

Menu 

Displays this list (menu) of commands 

ML 

Move legend 

Moves location of legend 

ND 

New data 

Prompts for new data format 

NF 

New files 

Prompts for new data files 

NP 

New parameters 

Prompts for new parameters 

PL 

Plot 

Draws the plot 

QU 

Quit 

Ends (quits) the program 

SA 

Save 

Saves the plot on a metafile 0 

SY 

Symbols 

Turns point symbols on or off 

TI 

Tide 

Prompts for plot title 

XL 

x label 

Prompts for jt-axis label 

XR 

x range 

Prompts for x-axis minimum and maximum values 

YL 

y label 

Prompts fory-axis label 

YR 

y range 

Prompts fory-axis minimum and maximum values 


“Precision Visuals, Inc., Boulder, Colorado. 
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Extended commands are described in the following tabu lation: 


Name 

Meaning 

Action 

CF 

Curve fit 

Prompts for curve-fit specifications 

DE 

Delete 

Prompts for box enclosing points to be deleted 

EP 

Exchange parameters 

Exchange-; the x and y parameters 

EX 

Exit 

Ends (exits) the program 

GI 

GIN location 

Reads GIN locations from screen or from a file 

GR 

Grid 

Turns background grid on or off 

GT 

Grid type 

Sets grid t ype to lines or dots 

LO 

Log scale 

Turns logarithmic scale on or off 

MA 

Move axes 

Moves lot ation of coordinate axes 

MS 

Move statistics 

Moves loc ation of curve-fit statistics 

NI 

Number of intervals 

Prompts ft >r number of intervals along axes 

PR 

Precision 

Sets maximum number of digits for tick label 

RE 

Replace 

Prompts for box enclosing points to be replaced 

RS 

Restore 

Restores deleted or replaced points 

RX 

Reverse x 

Reverses jr-axis minimum-to-maximum range 

RY 

Reverse y 

Reverses j -axis minimum-to-maximum range 

SC 

Scaling 

Sets or turns off data scaling 

SE 

Select 

Prompts for line patterns and symbol shapes 

SI 

Size 

Prompts for size of tick marks and label text 

SM 

Smoothing 

Turns line smoothing on or off 

SO 

Sorting 

Turns sorting on or off 

SS 

Start-stop 

Displays fight data start and stop times 

ST 

Statistics 

Sets or turns off curve-fit statistics legend 

su 

Save userinput 

Saves or deletes file EZPLOT.U SERIN PUT 

sw 

Switch 

Reads commands from $stdin or file 
EZPLO f.COMMANDS 

TH 

Thinning 

Sets or turns off thinning percentage 

TR 

Translation 

Sets or turns off data translation 

UN 

Units 

Sets or turns off unit conversions 

WH 

Where is GIN? 

Displays location of GIN cursor 

YA 

y axes 

Selects single or multiple y axes 


Text Commands are described in the following tabulation: 


Name 

Meaning 

Action 

Mn 

Move line n 

Moves location of text line n 

Pn 

Path line n 

Sets path and justification of text line n 

Sn 

Size line n 

Sets size of characters in text line n 

Tn 

Text line n 

Prompts for or t urns off text line n 


All labels and text lines are displayed on the plot in uppen ase characters even though all entry is case insensitive. 
To delete the contents of a label or a line of text, enter a null character. On many terminals, a null character may 


7 








be entered by pressing the escape (ESC) key followed by the control (CTRL) key, which is held down while the 
space bar (SPACE) is pressed. This keystroke sequence is referred to in the following pages as ESC CTRL SPACE. 
Pressing only the space bar followed by a carriage return usually causes the program to respond as if only a carriage 
return had been entered. 

Detailed descriptions of individual commands may be viewed by typing a question mark followed by the two- 
character command name. The text of these descriptions is given in the following listing in alphabetical order by 
command name. 

CF (curve fit) — Command CF toggles the curve fitting option on or off. When CF is on, data for a single 
dependent parameter may be fitted with up to a ninth-order, least-squares polynomial curve. This curve is identified 
and treated by the program as a second dependent parameter (see fig. 5). When CF is off (the initial default value), 
no curve-fitting parameters are calculated or displayed even if they were present on a previous plot. This command 
is illegal when two or more curves are displayed. 

DE (delete) — Command DE provides a way to delete from the plot selected groups of data points. After a plot 
is drawn and the DE command is selected, a rectangular box is drawn around the area containing the points to be 
deleted (see fig. 6). This box is defined by marking the screen locations of the lower left-hand and upper right-hand 
comers of the box as described in the Screen Locations section. These locations are called graphics input (GIN) 
locations. This command may be used repeatedly, without redrawing the plot, to define up to 1000 groups of points 
to be deleted. When the plot is redrawn, the points within the box or boxes do not appear. If the plotted points are 
connected with a line, that section of the line falling within the box is drawn linearly between the two points along 
the curve just outside the box boundaries. Deleted points may be restored with the RS command. Command DE is 
illegal when multiple y axes are displayed or when an axis is reversed or scaled logarithmically. See commands GI 
and WH for more information. 

EP (exchange parameters) — Command EP causes the dependent parameter or parameters to be plotted along 
the horizontal x axis and the independent parameter to be plotted along the vertical y axis. Axes scales and labels are 
adjusted accordingly. The position and orientation of the plot title, figure title, text lines, and legend labels are not 
affected. Any points previously deleted or replaced are restored. When command EP is reentered, normal parameter 
orientation is restored. This command is illegal when multiple y axes are displayed. 

EX (exit) — Command EX terminates program execution. Any plot currently displayed remains visible. All 
messages and prompts are erased. All files opened by the program are closed, and control is returned to the EZPLOT 
shellfile. The session ends when control is passed from the shellfile back to the host operating system. An EX may 
be entered in response to any prompt. 

FI (figure) — Command FI toggles the figure label on or off. When FI is on, the program prompts for the 
contents of the figure label. This label is a line of up to 80 characters of text that is centered at the bottom of the 
plot below the x-axis label (see figs. 1 to 6). As part of the prompt, the current contents, if any, are displayed as the 
default. Press the ESC CTRL SPACE keys to enter a null character. When FI is off (the initial default value), the 
figure label does not appear. 

GI (GIN location) — Command GI toggles between reading GIN locations from the screen or from a file. For 
interactive plotting, GIN locations are usually read from the screen in a terminal-dependent manner (see the Screen 
Locations section). They may also be read from the keyboard or from EZPLOT. COMMANDS. When read from 
the keyboard or a file, the locations must always be X,Y pairs where X and Y may be integer or real numbers and 
must be separated by a space or a comma. For batch execution, $stdin must be redirected, and GIN locations are 
always read from either this redirected file or from E7.PLOT.COM MAN DS. The initial default choice is to read GIN 
locations from the screen. See commands SW and WH for more information. 

GR (grid) — Command GR toggles the background grid on or off. When GR is on, a background grid of solid 
or dotted lines aligned with the axes tick marks is displayed (see fig. 1). The grid line pattern is selected with the 
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GT command. When GR is off (the initial default value), no background grid is displayed. This command is illegal 
when multiple y axes arc displayed. 

GT (grid type) — Command GT causes either solid or lotted lines to be used for the background grid. The 
solid-line grid (the initial default value) is drawn very rapidly . However, the weight of the grid lines is the same as 
the weight of the axes and curve lines. A lighter weight grid can be drawn using dotted lines (see fig. 1). However, 
this grid is drawn quite slowly on some terminals and should be avoided when rapid plot display is a consideration, 
especially when there arc more than ten tick marks on an axis. For a logarithmically scaled axis, the grid line at each 
major tick mark is solid even if the grid line at each minor tick mark is dotted (see fig. 2). This command is illegal 
when multiple y axes are displayed. 

LE (legend) — Command LE toggles the line and symbol legend on or off (see figs. 1 and 4). If only one curve 
is plotted, the line and symbol legend does not appear even if LE is oa This command is illegal when multiple y 
axes are displayed. 

LI (lines) — Command U toggles the plotted lines on or off. When U is on (the initial default value), the 
program connects the plotted data points with a solid line or liies made up of a variety of dashed patterns (see fig. 1 ). 
If two or more dependent parameters are plotted, line visibility can be turned on or off for all curves as a group or 
separately for each individual curve. When LI is off, no lines appear. When both LI and ST are off, a marker symbol 
is drawn at each data point. 

LL (legend label) — Command LL prompts for the coments of line and symbol legend labels. When two or 
more curves are plotted, a legend is displayed containing identifying information for the line patterns and symbol 
shapes used. Each curve is described on a separate line by a legend label containing up to 80 characters of text (see 
figs. 1, 4, and 5). As part of the prompt, the current text for each line is displayed as the default. Press the ESC 
CTRL SPACE keys to enter a null character. By default, when data from different files are plotted, the labels initially 
contain the names of files. If ELXSI pathnames are used, only those parts of the pathnames that are the names of 
the files are put in the legend. When two or more dependent parameters are plotted, the labels initially contain the 
names of the dependent parameters. No legend is displayed if only one curve is plotted or if command LE is off. 
C omman d LL is illegal when multiple y axes are displayed. 

LO Gog scale) — Command LO turns the logarithmic scale on or off. Either the x axis or the y axis, or both 
may be scaled linearly or logarithmically. When LO is on, the axis is scaled logarithmically (see fig. 2). Because it 
is not possible to plot data values less than or equal to zero on a logarithmic scale, the program plots such data on a 
linear scale regardless of the value of LO. If multiple y axes are drawn, only the x axis can be scaled by LO even if 
only one dependent parameter is plotted. The effects of this command may be partially overridden by the XR and 
YR commands. When LO is off (the initial default value), the number of intervals and the minimum and maximum 
values displayed are determined by linear scaling. Under cert, tin conditions, the effects of LO are unpredictable (see 
the Known Bugs section). 

MA (move axes) — Command MA provides a way to move the location and size of the plotting area on the 
screen. After a plot is drawn and the MA command is selected, the GIN locations of the lower left-hand and upper 
right-hand comers of the desired plotting area are marked a.*; described in the Screen Locations section. The GIN 
location chosen for the intersection of the x and y axes is also marked. The tick mark numbers may be placed along 
the axes or along the bonders of the plotting area. When the plot is redrawn, it appears in the area and with the 
configuration just defined. Any points previously deleted or replaced are restored. Figure titles, legends, and text 
lines are not moved with this comm and. Command MA is illegal whenmultipley axes aredisplayed. See commands 
GI and WH for more information. 

ME (menu) — Command ME causes a list (menu) of all s he two-character plot commands to be displayed. This 
list includes a brief description of the action the program takes in response to each command. 
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ML (move legend) — Command ML provides a way to move the location of the line and symbol legend. After 
a plot is drawn and the ML command is selected, the GIN location chosen for the upper left-hand comer of the 
legend is marked as described in the Screen Locations section. When the plot is redrawn, the legend appears in 
the new location. This command is illegal when multiple y axes are displayed. See commands GI and WH for 
more information. 

MS (move statistics) — Command MS provides a way to move the location of the curve-fit statistical legend. 
After a plot is drawn and the MS command is selected, the GIN location chosen for the upper left-hand comer of 
the statistical legend is marked as described in the Screen Locations section. When the plot is redrawn, the legend 
appears in the new location provided command ST is on. Command MS is illegal when multiple y axes are displayed. 
See commands GI and WH for more information. 

Mn (move line n ) — Command Mn provides a way to move the location of the nth text line (where n = 1 to 
9). After a plot is drawn and the Mn command is selected, the GIN location chosen for the center or left edge of the 
text line is marked as described in the Screen Locations section. When the plot is redrawn, the text line appears in 
the new location provided command Tn is on. See commands GI and WH for more information. 

ND (new data) — Command ND provides for the selection of a new data input format. The program presents 
the menu that prompts for a choice of input format of the data to be plotted. These data may come from a flight data 
file, a generic data file, or the keyboard. A U entered in response to this menu causes the text of an on-line EZPLOT 
user’s guide to be displayed. After the new data input format is selected, the program continues with the normal 
sequence of prompts for file and parameter names. This command is illegal when the independent and dependent 
parameters are exchanged. 

NF (new files) — Command NF provides for the selection of new data input files. The program prompts for the 
name or names of files from which data are to be read. The previous files selected are presented as defaults. After 
the file names are entered, the program continues with the prompt for the names of the parameter to be plotted. This 
command is illegal when the independent and dependent parameters are exchanged. 

NI (number of intervals) — Command NI provides a way to specify the number of tick-marked intervals along 
the axes. Values from 1 to 99 are allowed. The initial default values are 10 intervals along the x axis and 8 intervals 
along the y axis (see fig. 1). When multiple y axes are used, there are two intervals for each dependent parameter 
even if only one dependent parameter is plotted. Command NI is illegal for multiple y axes and logarithmically 
scaled axes. 

NP (new parameters) — Command NP provides for the selection of new parameters. The program prompts 
for the names of the parameters to be plotted. The previous names selected are presented as defaults. If a default 
parameter is selected containing points that were previously deleted or replaced, these points are restored. Command 
NP is illegal when the independent and dependent parameters are exchanged. 

PL (plot) — Command PL causes a plot to be drawn on the screen. All text and graphics information currently 
displayed are erased prior to drawing the plot. The program does not automatically draw a plot after the’dependent 
parameter or parameters have been chosen. This allows for selection of other than default values for various plot 
attributes before drawing the first in a scries of plots. 

PR (precision) — Command PR prompts for the number of digits to be used to label each tick mark. Values 
from 5 to 20 are allowed. The initial default value is 8. A label may interfere with an adjacent label if too many 
digits are used. 

Pn (path line n) — Command Pn prompts for the character path and justification of text line n. Path, the 
directional orientation of the line, may be horizontal or vertical. Horizontal lines read from left to right Vertical 
lines read from bottom to top. Justification, the location within the line used to position the line on the plot, may be 
the left (or bottom) edge or the center. 
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QV (quit) — Command QU terminates program execution. All plots, messages, and prompts currently dis- 
played arc erased. All files opened by the program arc closed, and control is returned to the EZPLOT shell file. The 
session ends when control is passed from the shellfilc back to the host operating system. A QU may be entered in 
response to any prompt. 

RE (replace) — Command RE provides a way to replace selected groups of data points. After a plot is drawn 
and the RE command is selected, a rectangular box is drawn around the area containing the points to be replaced 
(see fig. 6). This box is defined by marking the screen locations of the lower left-hand and upper right-hand comers 
of the box as described in the Screen Locations section. This command may be used repeatedly, without redrawing 
the plot, to define up to 1000 groups of points to be replaced. When the plot is redrawn, the points within the box 
or boxes arc replaced with an equal number of points lying along a straight line connecting the two points along the 
curve just outside the box boundaries. Replaced points may be restored with the RS command. Command RE is 
illeg al when multiple y axes are displayed or when an axis is reversed or scaled logarithmically. See commands GI 
and WH for more information. 

RS (restore) — Command RS causes all points that have *en deleted or replaced to be reinserted at their original 
location on the plot. This command is illegal when multiple y axes are displayed. 

RX (reverse x) — Command RX causes the current direction for plotting minimum to maximum values along 
the x axis to be reversed. The data may be plotted with the minimum value on the left and the maximum value on 
the right, or conversely. By default, the minimum to maximum values are plotted from left to right. This command 
is illegal for a logarithmically scaled axis. 

RY (reverse y) — Command RY causes the current direction for plotting minimum to maximum values along 
they axis to be reversed. The data may be plotted with the minimum value on the bottom and the maximum value on 
the top, or conversely. By default, the minimum to maximum values arc plotted from bottom to top. This command 
is illegal for a logarithmically scaled axis. 

SA (save) — Command SA causes the current plot to be saved on a metafile. The action of this command is 
fully described in the Metafiles section. 

SC (scaling) — Command SC toggles separate scaling (multiplying) factors on or off. When SC is on, the 
independent and dependent parameter data values are multiplied by factors entered from the keyboard. If two or 
more dependent parameters are plotted, scaling can be turned on or off for all curves as a group or separately for each 
individual curve. When SC is off (the initial default value), no scaling is done. When this command is used, any 
points previously deleted or replaced are restored. Scaling is turned off when command ND, NF , or NP is entered. 

SE (select) — Command SE prompts for line pattern and symbol shape choice. By default, when only one 
curve is plotted, the line is solid and the symbol is a circle. When two or more curves are plotted, the second and 
subsequent lines are dash-patterned if no symbols are drawn (see fig. 1). If symbols are drawn, the lines are solid 
and the symbols are variously shaped (see figs. 2 and 4). The default order of patterns and shapes may be overridden. 
The number of the line pattern and the symbol shape correspond to the number of the curve and not to the parameter 
naiw Thar is, line pattern 1 is used to draw the first curve, line pattern 2 is used to draw the second curve, and so on. 
Any line pattern or symbol shape may be selected repeated] y and used to draw more than one curve. Visibility of 
linw and symbols is determined by the value of the LI and SY commands. When both LI and SY are off, a marker 
symbol is drawn at each data point. 

SI (size) — Command SI prompts for the horizontal and vertical size of the characters in the x axis, y axis, plot 
title, figure, legend, statistics, and tick-mark labels. Each size must be in the range 0.001 to 100.0. The default size 
of the plot title and figure label is 2.0, 2.0. The default size of the other labels is 1.5, 1.5. 

SM (smoothing) — Command SM toggles line smoothing on or off. When SM is on, a smoothed (curved) 
line is drawn between points using an algorithm called splines under tension (see ref. 2). If two or more dependent 
parameters are plotted, smoothing can be turned on or off for all curves as a group or separately for each individual 
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curve. When SM is off (the initial default value), a straight line is drawn between successive data points. This 
command is effective only if command LI is on and sometimes fails if there are more than about 50 data points (see 
the Known Bugs section). 

SO (sorting) — Command SO toggles sorting on or off. When SO is on, all subsequent input data are sorted by 
increasing value of the independent parameter before any plots are drawn. If the data have been previously thinned, 
the first and last points may not represent the minimum and maximum values, respectively, in the unthinned data 
set Sorting is most useful when lines are displayed. When SO is off (the initial default value), no sorting is done. 

SS (start-stop) — Command SS causes the start and stop times for the data interval on a flight data input file to 
be displayed as [ hh : mm : ss . mi 1 ] . 

ST (statistics) — Command ST provides for selection of what statistical data to display on the plot. When the 
curve-fit command CF is enabled, the mean deviation, variance, and standard deviation are calculated and may be 
displayed on the text plane, the graphics plane, or both (see fig. 5). Also displayed is the form of the equation and 
the value of the coefficients. For example, y = AX + BX2 + CX3 + ... 

SU (save userinput) — Command SU toggles the option to save file EZPLOT.USERINPUT on or off. All 
commands and other information entered during program execution are written on a temporary file. When SU is on, 
the contents of this temporary file are copied to file EZPLOT.USERINPUT which is saved in the current directory 
after the temporary file is deleted and program execution stops. When SU is off (the initial default value), neither file 
is saved. For jobs run in batch mode, the name EZPLOT.USERINPUT is prefixed automatically with the characters 
j[jobIDJ. where [joblDJ is the job identification number. 

SW (switch) — Command SW toggles between $stdin (usually the keyboard) and file EZP LOT. COMMANDS 
for command entry. At startup, after the terminal type has been entered, the program attempts to read and execute 
commands from file EZP LOT. COMMA NDS in the current directory. If this file is empty or an SW command is 
encountered, the next command is read from $stdin. If an SW is encountered on $stdin (for example, entered from 
the keyboard), the program attempts to read the next command from EZPLOT. COMMANDS. This process continues 
until a QU or an EX command is read and executed from either source. $stdin may be redirected from the keyboard 
to a file. 

SY (symbols) — Command SY toggles the plotted symbols on or off. When SY is on, symbols with a variety of 
shapes are drawn at the plotted points (see fig. 4). If two or more dependent parameters are plotted, symbol visibility 
can be turned on or off for all curves as a group or separately for each individual curve. When SY is off (the default 
value), no symbols are drawn. When both LI and SY are off, a marker symbol is drawn at each data point. 

Sn (size line n) — Command Sn prompts for the horizontal and vertical sizes of the characters in text line n. 
Each size must be in the range 0.001 to 100.0. The default size is 2.0, 2.0. 

TH (thinning) — Command TH toggles data point thinning on or off. When TH is on, the program prompts 
for the percentage of data points to be plotted out of the total number available. This percentage may vary from 1 to 
100, where 100 percent means to plot all the points. Point deletion is evenly distributed along the curve. The first 
and last points are always retained. When TH is off (the initial default value), all available points are plotted. 

Tl (title) — Command 77 toggles the plot title on or off. When 77 is on, the program prompts for the contents of 
the plot title. This title is a line of up to 80 characters of text that is centered at the top of the plot above the plotting 
area (see fig. 1). As part of the prompt, the previous contents, if any, are displayed as the default. Press the ESC 
CTRL SPACE keys to enter a null character. When TI is off (the initial default value), the plot title does not appear. 

TR (translation) — Command 77? toggles separate translation (bias) factors on or off. When TR is on, the 
independent and dependent parameter data values are biased by factors entered from the keyboard. If two or more 
dependent parameters are plotted, translation can be turned on or off for all curves as a group or separately for each 
individual curve. When TR is off (the initial default value), no translation is done. When this command is used, 
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any points previously deleted or replaced are restored. Trar slation is turned off when command ND, NF, or NP 
is entered. 

Tn (text line n) — Command Tn toggles the nth text line on or off. When Tn is on, the program prompts for 
the contents of the line. Up to nine lines containing up to 80 characters of text each may be displayed on a plot (see 
fig. 1). As part of the prompt, the current contents, if any, are displayed as the default. Press the ESC CTRL SPACE 
keys to enter a null character. When Tn is off (the initial default value), line n does not appear. 

UN (units) — Command UN toggles unit conversion factors on or off. When UN is on, the independent and 
dependent parameter data values are scaled (multiplied) and translated (biased) as follows: adjusted data value = 
A * (unadjusted data value) + B where A and B are factors entered from the keyboard. If two or more dependent 
parameters are plotted, unit conversion can be turned on o off for all curves as a group or separately for each 
individual curve. When UN is off (the initial default value), to unit conversion is done. This command makes use 
of the same factors and operates in the same way as commands SC and TR combined. When command UN is used, 
any points previously deleted or replaced are restored. Unit o inversion is turned off when command ND, NF, or NP 

is entered. 

WH (where is GIN?) — Command WH provides a way 10 display the present location of the GIN cursor. After 
a plot is drawn and command WH is selected, the GIN cursoi is moved to the location to be displayed in a terminal- 
dependent manner (see the Screen Locations section). World oordinates and engineering units are both shown when 
the location is within the plot axes. When the location is ou side the plot axes, only world coordinates are shown. 
When multiple y axes are displayed, the y location is shown n world coordinates only. 

XL (x label) — Command XL toggles the x-axis label on or off. When XL is on (the initial default value), a line 
of up to 80 characters of text appears centered below the x-aris tick-mark numbers (see figs. 1 to 6). The name of 
the independent parameter is the initial default contents of th ; x-axis label. If the label is changed, the new contents 
remain the default until a subsequent change or until a new ir dependent parameter is selected. The name of the new 
independent parameter then becomes the default. Press the ESC CTRL SPACE keys to enter a nuU character. When 
XL is off, this label does not appear. 

XR (x range) Command XR prompts for the minimum and maximum values to be displayed on the x axis. 

Current minimum and maximum values are displayed as defaults. The initial minimum and maximum values are 
c a lc u la ted automatically to allow for all the input data to lie plotted. The effect of changing these values is to 
increase or decrease the x-axis range. This is useful for "wine owing" the data or for creating a more suitable interval 
between tick marks. Data that subsequently fall outside the plot borders are not displayed. Because the results of this 
command may be affected by command LO, windowing on a logarithmically scaled axis should be done after LO is 
selected. Command XR may then be used to change the number of intervals on the logarithmic axis, if desired. The 
x-axis scale is automatically recalculated as required any time a ND, NF , or NP command is selected. 

YA (y axes) — Command YA provides for selection of single or multiple y axes. When multiple axes are chosen, 
there is one y axis for each of up to eight dependent parameters (see fig. 3). Each y axis is scaled independently 
from the others. If only one dependent parameter is plotted, tiiere is only one y axis. There is always only one x axis. 
Commands DE, EP, GR, GT, LE, LL, MA,ML, MS, RE, and RS are illegal when multiple y axes are displayed. 

YL (y label) — Command YL toggles the y-axis label on or off. When YL is on (the initial default value), 
the label is displayed. The form of this label varies accordi ng to the number of y axes displayed and the number 
of dependent parameters plotted. For a single y axis and >ne dependent parameter, this label is a line of up to 
80 characters of text that appears centered to the left of the y-axis tick-mark numbers (see figs. 2 and 6). The text 
reads from bottom to top with the characters rotated 90° counterclockwise with respect to the x-axis label. For a 
single y axis and more than one dependent parameter, the label is optional and a line and symbol legend is drawn 
(see figs. 1,4, and 5). For more than one y axis, there is one abel for each axis plus an additional label for all y axes 
together (see fig. 3). Labels for individual y axes should net be longer than the relevant axis to avoid interference 
with adjacent labels. 
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For all cases, the initial default content of this label is the name or names of the dependent parameter or parameters 
if all the data come from one data input file, or the names of the files when there is more than one data input file. If the 
label is changed, die new contents remain the default until a subsequent change or until a new dependent parameter 
or a new data input file is selected. The name or names of the new dependent parameter or parameters or data input 
files then become the default. Press the ESC CTRL SPACE keys to enter a null character. When YA is off, this label 
does not appear. 

YR (y range) — Command YR prompts for the minimum and maximum values to be displayed on the y axis. 
Current minimum and maximum values are displayed as defaults. The initial minimum and maximum values are 
calculated automatically to allow for all the input data to be plotted. The effect of changing these values is to 
increase or decrease the y-axis range. This is useful for "windowing" the data or for creating a more suitable interval 
between tick marks. Data that subsequently fall outside the plot borders are not displayed. Because the results of 
this command may be affected by command LX), windowing on a logarithmically scaled axis should be done after 
LO is selected. Command YR may then be used to change the number of intervals on the logarithmically scaled 
axis, if desired. The y-axis scale is automatically recalculated as required any time a ND, NF, or NP command is 
selected. When multiple y axes are displayed, the range of each axis can be specified separately. 

Screen Locations 

Plot Commands DE, MA, ML, MS, Mn, RE and WH make use of die DI-3000 virtual graphics input function 
LOCATOR (ref. 2) to provide for specification of screen locations. These locations are often specified in a terminal- 
dependent manner. Many graphics terminals can display a crosshair of intersecting lines that can be moved across 
the screen until their intersection indicates the position on the screen to be specified. For most terminals, the lines 
are moved by pressing the arrow keys on the keyboard. Pressing the shift key in conjunction with an arrow key may 
speed up the motion. Some terminals have more than one set of arrow keys. If one set produces no response, try the 
other set. For Tektronix 4107 and 4109 terminals, a joydisk on the keyboard is used instead of arrow keys. Other 
terminals may use a joystick, thumbwheels, a light pen, or a mouse to move the lines or some other marker. 

When the lines intersect at the desired location, the space bar is pressed once or twice, depending on the terminal, 
to specify or “mark” this position. On some terminals, other keys or buttons may be used instead of the space bar. 
If the COMMAND? or some other prompt appears immediately after the space bar is pressed once, there is no need to 
press it again. If the lines disappear and a blinking cursor appears over the selected location but no prompt appears, 
the space bar must be pressed one more time. This action transmits the display coordinates of the location to the 
program. These coordinates are also briefly displayed on the screen. 

Screen locations may also be read from a file as pairs of numbers representing X,Y display coordinates (see 
commands Gl and WH ). The effect within the program is the same as when the locations are entered directly from 
the screen. The previous coordinates of the screen location do not change if an error occurs when the numbers 
are read. 

Metafiles 

Plots may be saved during program execution on DI-3000 metafiles (ref. 5). Each plot on a metafile is called a 
picture and is stored as a series of records containing digitized plot information that can be interpreted by DI-3000 
Metafile Translator utilities. After a session ends, plots saved on a metafile may be reviewed on the screen or plotted 
on an auxiliary plotter without reexecuting EZPLOT. 

Plots are saved with the SA command and have the attributes in effect when the command is executed. To speed 
the process, plots are not drawn to the screen when saved. Therefore, it is often a good idea to review the plot prior to 
saving it by entering a PL command just before a SA command. For the first plot (picture), a nam e for the metafile 
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is entered followed by a name (title) for the picture. File nar les may contain up to 24 characters, while picture titles 
may contain up to 50 characters. For the second and following pictures, only the picture title is entered. Pictures 
are stored sequentially on a metafile. During any one EZPL OT session, only one metafile is generated. Therefore, 
if plots are to be stored on more than one metafile, the current session must be terminated with the plot command 
QU and a new session begun with the ELXSI command ezplot. 

Metafile pictures may be drawn with a DI-3000 Metafile Translator linked with the appropriate device driver. 
The device drivers available on the ELXSI may be listed by mtering the command ListGraphicsDrivers in response 
to the normal EMBOS prompt. 

Here is an example. After the ELXSI command metranx.tM is entered, where tl4 is the ELXSI device driver 
abbreviation for graphics terminals that emulate the Tektroni x 4014, the Metafile Translator prompt M> is displayed. 
The following command sequence is then entered in response to a prompt for each line. The shorter form of each 
command is shown in parentheses. MF.XY is the name of tf e metafile. 

Set metafile I MF.XY (S MF 1 MFXY ) 

Directory 1 (DIR 1) 

Draw picture 2 (DPI) 

Draw picture 3 (D P 3) 

Draw picture 4 (DP 4) 

Quit (Q) 

In this example, three separate plots are displayed as the draw picture command is executed for the second, 
third, and fourth picture on the file. The first picture is always blank and should not be drawn. The space bar must be 
pressed once or twice after each picture is drawn to redisplay the Metafile Translator prompt. Other keys or buttons 
may be used instead of the space bar depending on the terminal. The directory command displays the titles of the 
pictures on the file and may be omitted. 

Metafiles saved in the current interactive session are corrupted if command EX is used to end execution. Com- 
mand QU should be used in this situation. For batch execution, command EX is equivalent to QU and does not 
corrupt files saved with command SA. 

An alternative way to save plots is described in appendi x C. 

Redirection and Batch Operation 

EZPLOT is normally run interactively by entering commands and responses from the keyboard. An alternative 
way to run the program is to put these keyboard entries into a file, one entry per record, and redirect $stdin to this file. 
For example, the command line ezplot.cmd > ezplot directs the EZPLOT shellfile to take entries from file ezplot.cmd 
instead of the keyboard. This is a convenient way to store and use what may sometimes be a lengthy set of keyboard 
entries to draw a series of similar plots. 

Here is a sample of what a typical file named ezplot.cmd might contain. The following comments in parentheses 
are given here for explanation and are not part of the record '! on the file. 
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g select Graphon terminal type 

g (select generic data) 

zgen (name of file containing generic data) 

(standard command, end file name entry) 
y (yes, names are correct) 

x (name of independent parameter) 

y (name of dependent parameter 1) 

z (name of dependent parameter 2) 

w (name of dependent parameter 3) 

(standard command, end parameter name entry) 
y (yes, names are correct) 

GR (turn on grid) 

PL (draw plot) 

EX (end execution) 

This procedure does not allow for any keyboard entry after the program has started execution. When all com- 
mands and responses have been processed, the noimal ELXS1 prompt reappears and the plot remains on the screen. 
To generate another plot, the entire sequence of entries is processed. Be sure that the file does not contain a QU 
command. If it does, the plot is erased when the ELXSI prompt reappears. 

If a file named EZPLOT, COMMANDS is present in the current directory when this sample job is executed, the 
operation described is modified slightly. After the terminal type is read from ezplot.cmd, the next response is read 
from file EZPLOT. COMMANDS. If this response is the command SW, all commands and responses that remain 
on ezplot.cmd are read and executed. If this response is not the command SW, the program continues to read and 
execute commands and responses from EZPLOT. COMMANDS until an SW command or an end of file is reached. 
All commands and responses remaining on ezplot.cmd are then read and executed. 

If the current directory contains an EZPLOT. COMMANDS file that should not be used and that cannot be deleted, 
enter no commands in response to the prompt for terminal type at program initiation. When the prompt is repeated, 
enter the appropriate terminal type to begin execution. 

To help the user create files similar to ezplot.cmd, all commands and responses, including GIN locations entered 
through the keyboard during an interactive session, are written on a file named EZPLOT.USERINPUT. This file may 
be saved, if desired, and used as the basis of an ezplot.cmd file. See command SU for more information. 

This procedure may also be executed in a noninteractive batch mode, which, on the ELXSI computer, runs 
independently from any user input. Therefore, $stdin must be redirected to a file that contains all the information 
normally entered from the keyboard to generate a plot, including GIN locations, where appropriate. The plot is not 
drawn on the screen and should be saved on a metafile to be plotted at a later time. 

If no EZPLOT. COMMANDS file exist in a directory, any number of users may execute any combination of 
interactive and batch EZPLOT jobs in that directory at the same time. Be aware, however, that metafiles and file 
EZPLOT.USERINPUT previously written by one user may be overwritten by another user at some later time. 

If an EZPLOT. COMMANDS file does exist in a directory, only one interactive job may be executed in that 
directory at any given time. If no interactive jobs are executing, any number of batch jobs may be executed at the 
same time with the understanding that they all use the same EZPLOT. COMMANDS file. 

Error and Warning Messages 

EZPLOT messages. — If an error or other abnormal condition is detected by EZPLOT, a message is displayed 
identifying the problem. The text of each error and warning message follows in alphabetical order. 


16 



CAHNOT FIT LESS THAN 2 POINTS - This message, generated by subroutine CURFIT, indicates that an 
attempt was made to fit a line through only one data point. 

CANNOT OPEN FILE "xxxxx" — This message, generated by subroutines FILES and GENRIC, indicates that 
a selected file could not be opened for access to input c ata. 

CANNOT WRITE IN THIS DIRECTORY — This message, generated by subroutines FILES and SAVEPL, in- 
dicates that the user does not have permission to write a file in the current directory. 

PRNNOT WRITE METAFILE WHEN USING PLOTFILI —This message, generated by subroutine USER, , in- 
dicates that an attempt was made to write plot data to a metafile when the shell variable PlotFUe was ac ive 

(see app. C). 

f 7 plot DETECTS ERROR AT OR NEAR RECORD nnnnn, FILE "xxxxx" -This message, generated 
by subroutine GENRIC, indicates a problem with the format of generic data input file xxxxx. Remem r 
comments, if present, are record number 1. 

FILE "xxxxx" DOES NOT EXIST — This message, generated by subroutine FILES, indicates that a file 
JZZxxbx does not exist in the specifled EMBOS dnectory. usually the current dttectoty. Common causes 
are spelling errors and incomplete or incorrect pathnames. 

FIRST CHARACTER MAY NOT BE A NUMBER - This message, generated by subroutine HELP, indicates 
that help information was requested about a string that, began with a num r. sis ega . 

illegal command - This message, generated by subroutine USER, indicates that a two-charaoer string has 
been entered that does not match any of the legal commands. 

ILLEGAL COMMAND: LONGER THAN 2 CHARACTERS -This message, generated by subroutine USER, in- 
dicates that a string of more than two characters was entered as a plot command. 

TT LEGAL GENERIC DATA VALUE — This message, generated by subroutine GENRIC, indicates that an illegal 
value was encountered in the data on a generic file. A common cause is the presenceof 

in the data values— except for E as part of an exponential number, which is permitted. Another possible caus 
?!£££££ ^°o small for single-precision arirhmeric. If UK Ble is fonnaned, die line comammg 

the error is displayed. 

ILLEGAL INPUT — This message indicates that an illegal siring has been entered from the keyboard. TtespeciBc 
proWems L migh, be encountered are described hem for each submarine that generates this message. 

NUMINT An illegal value has been entered for the number of rick marks along an axis. Legal values are 

from 1 to 99. . 

PRECIS An illegal value has been entered for the number of digits used to label each tick m g 

values are from 5 to 20. 

SCALER, TRANSL, UNITS, XRANGE, and YRANGE -A nonnumeric character has been used in spec- 
ifying a numerical value. Legal entnes must be numbers. 

SIZLBL and SIZTXT — An illegal value has been entered for the size of the characters in a label or a line 
of text. Legal values are from 0.001 to 100. 

STATS -Anonintegeroranintegerotherthanfrom 1 to 5 has been entered when choosing which statistical 
information to display. 

THIN — An illegal value has been entered for the thinning factor. Legal values are from 1 to 100. 
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ILLEGAL INPUT (ENTER " FOR HELP) — This message, generated by subroutine FILES, FLIGHT, 
GETDAT, GETGEN, and GINPUT indicates that an illegal entiy, usually an inappropriate character or a mis- 
spelled name, has been made from the keyboard. A question mark causes helpful information to 
be displayed. 

ILLEGAL NUMBER OF PARAMETERS — This message, generated by subroutine GENRIC, indicates that the 
value of the integer specifying the number of parameters on a generic file was less than one. If the file is 
formatted, the illegal value is displayed. 

ILLEGAL PARAMETER NAME — This message, generated by subroutine GENRIC, indicates that the syntax of 
a parameter name on a generic file is incorrect Look for missing or extra apostrophes in the list of names. 
Also, the number of parameter names may not match the value of the integer specifying how many names to 
read. If the file is formatted, the line containing the error is displayed. 

ILLEGAL WITH EXCHANGED PARAMETERS — This message, generated by subroutine USER, indicates that a 
request for new data, new files or new parameters was entered when the independent and dependent parameters 
were exchanged. Commands ND, NF, and NP are illegal in this situation. 

ILLEGAL WITH LOGARITHMIC SCALE — This message, generated by subroutine USER, indicates that a re- 
quest was entered to reverse the direction of plotting along a logarithmically scaled axis or to delete or replace 
a group of data points when one or both axes are scaled logarithmically. Commands DE, RE, RX, and RY are 
illegal in these situations. 

ILLEGAL WITH MORE THAN ONE CURVE — This message, generated by subroutine IISF.R, indicates that a 
curve fit has been requested when more than one curve is displayed. The command CF is illegal in this 
situation. 

ILLEGAL WITH MULTIPLE Y AXES — This message, generated by subroutine USER, indicates that a com- 
mand has been entered that cannot be executed when multiple y axes are displayed. For this situation, the 
following commands are illegal: DE, EP, GR, GT, LE, LL, MA, ML, MS, RE, and RS. 

ILLEGAL WITH REVERSED AXIS — This message, generated by subroutine USER, indicates that a request 
has been entered to impose a logarithmic scale on an axis along which the direction of plotting is reversed, 
or to delete or replace a group of data points when the direction of plotting is reversed on one or both axes. 
Commands DE, RE, and LO are illegal in these situations. 

MATRIX IS EFFECTIVELY SINGULAR. TRY AGAIN — This message, generated by subroutine CURFTT, 
indicates that insufficient data were supplied to perform the desired curve fit. The curve fit option is 
turned off. 

MAXIMUM NUMBER OF DATA POINTS READ ON FILE "xxxxx" /REMAINDER WILL BE IGNORED 

This message, generated by subroutines FLIGHT and GENRIC, indicates that there were more than 10,000 
data points on file xxxxx. 

MAXIMUM NUMBER OF PARAMETERS REACHED ON FILE "xxxxx "/ONLY THE FIRST "nnnn" 

PARAMETERS will BE AVAILABLE — This message, generated by subroutines FLIGHT and GENRIC, 
indicates that the input file(s) contain data for more than 2000 parameters. This limit was reached while 
reading file xxxxx. 

NO MORE COMMANDS ON FILE "EZPLOT . COMMANDS"; USE KEYBOARD TO ENTER COMMANDS 

This message, generated by function READSW, indicates that an end of file has been reached on file 
EZPLOT. COMMANDS. Either the file is empty or all commands on it have been executed. All further com- 
mands must be entered from the keyboard. 
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NUMBER OF DIGITS MUST BE BETWEEN 5 AND 20 — This message, generated by subroutine PRECIS, 
indicates that an illegal value has been entered for the number of digits to be written in the label for each axis 
tick mark. Legal values are from 5 to 20. 

NUMBER OF INTERVALS MUST BE BETWEEN 1 ANI 99 — This message, generated by subroutine 
NUMINT, indicates that an illegal value has been entered for the number of tick marks along an axis. Le- 
gal values are from 1 through 99. 

NO PARAMETER NAMES READ; CHECK FILES — This message, generated by subroutines FLIGHT and 
GENRIC, indicates that the parameter names on a data input file cannot be read. A common cause is the 
lack of an integer on a line by itself specifying the number of parameters on a generic file, 

"OPENR" FAILED TRYING TO OPEN FILE "xxxxx" — This message, generated by subroutine FLIGHT, 
indicates that file xxxxx could not be opened for access to input data. 

ORDER MUST BE 1 — This message, generated by subroutine CURFIT, indicates an attempt was made to fit 
something other than a straight line through two data points. 

ORDER MUST BE BETWEEN 1 AND n — This message, generated by subroutine CURFIT, indicates the cur- 
rent limits on the order of curve fit allowed. The maxi mum order of fit allowed may be less than nine if the 
number of data points is small. 

PARAMETER "yyyyy" NOT FOUND/ENTER "?" TO DISPLAY AVAILABLE PARAMETERS — This 
message, generated by subroutine FLIGHT and GETGEN, indicates that the parameter named yyyyy is not 
available to be plotted. A question mark causes the names of available parameters to be displayed. If there 
are two or more data files, only the names of the parameters available on the first file are displayed. 

PARAMETER "yyyyy" N0T FOUND ON FILE "xxxxx"/WILL PLOT WHAT'S AVAILABLE — This 
message, generated by subroutine GETGEN, indicates that when plotting from two or more files, the pa- 
rameter name yyyyy was found on at least one file but was not found on file xxxxx. The data that was found is 
plotted. Logarithmical scaling is inhibited for parameter yyyyy. The contents of file xxxxx may be listed and 
checked with the standard command DO cmd. 

SIGNAL yyyyy NOT FOUND. USING 0. — This message, generated by a GetData subroutine, indicates that 
parameter name yyyyy cannot be found on the data input file. Be sure the requested name is spelled correctly 
and exists on the data input file. 

SLOPE IS INFINITE; CANNOT FIT — This message, generated by subroutine CURFIT, indicates an 
attempt was made to fit a straight line between two points with the same value of independent variable. 

THAT'S NOT LEGAL HERE — This message, generated by various subroutines, indicates that a period has been 
entered at an inappropriate step during program execution. 

THERE IS NO DEFAULT — This message, generated by subroutines FILES, FLIGHT, and SAVEPL, indicates 
that a default file or parameter name is not available at Ibis step in program execution. A name must be entered 
from the keyboard. 

TOPIC NOT FOUND — This message, generated by subroutine HELP, indicates that help information was re- 
quested about a string that cannot be located anywhere in the command menu text 

"sssss” IS NOT A 2-LETTER COMMAND; WILL SEARCH FOR TOPIC — This message, generated by 
subroutine HELP, indicates that help information was requested about a string that is not a two-letter EZPLOT 
command. Every line in the command menu that contains string sssss is displayed. 
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YOU MUST ENTER AN INTEGER HERE — This message, generated by subroutine GINPUT, indicates that an 
attempt was made to enter something other than an integer as the number of parameters to be input in data 
format “I”. 

YOU MUST ENTER AT LEAST 2 AND NO MORE THAN n PARAMETERS — This message, generated by 
subroutine GINPUT, indicates an attempt was made to enter less than two or more than n, the maximum 
number of curves that can be plotted, as the number of parameters to be input in data format “I”. Currently, 
«= 8 . 

YOU MUST ENTER DIGITS IN THE RANGE 1 THROUGH 8 — This message, generated by subroutine 
SELECT, indicates that a 9, a 0, or a noninteger has been entered when specifying line patterns or symbol 
styles. Legal values are integers from 1 to 8. 

WARNING: PICTURE TITLE TRUNCATED TO THE FIRST 50 CHARACTERS — This message, gener- 
ated by subroutine S AVEPL, indicates that the text entered as the tide of a metafile picture contained more than 
50 characters. 

Operating system messages. — Errors and other abnormal conditions detected by the operating system may send 
messages to the screen. Errors detected by EMBOS while trying to execute a DO cmd cause a system-generated 
message to be displayed but usually do not cause a program session to end. Corrective action depends on the nature 
of the error and is often system dependent. Irrecoverable errors such as those caused by floating-point overflow often 
display a message beginning with the line EXCEPTION #nnn followed by several additional lines of information. 
These errors may cause the program session to end immediately. Corrective action usually involves selection of 
different parameters to be processed or modification of the input data. 

Known Bugs 

When there are more than about 1000 data points, the SM command sometimes fails during execution due to a 
floating-point overflow error. This error causes an EZPLOT session to end immediately. Therefore, until it has been 
tested for error-free execution, command SM should not be used when many plots are being generated and saved on 
a metafile. 

When data from more than one file are plotted and one or both of the selected parameters cannot be found on all 
the files, the associated axes cannot be scaled logarithmically even if no values are less than, or equal to, zero. 

No message is generated to indicate a mismatch between the requested data format type and the data actually on 
the file. For example, when flight data are requested and a file containing generic data is selected, the only indication 
of an error is that no parameters are available to be plotted. 

Tips for Efficient Usage 

Here are some guidelines for using EZPLOT easily and efficiently. 

1. Plotting several thousand points for each of several parameters can be quite time consuming even at baud 
rates of 9600. Thinning may be used to significantly reduce the plotting time. 

2. Because the dot grid is drawn relatively slowly, it should not be used when maximum screen plotting speed 
is desired. The line grid is drawn rapidly and usually does not require any significant waiting time. 

3. Curve fitting more than 1000 points can be very slow. Polynomials of order greater than six are not recom- 
mended because of long execution times and uncertain results. 
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4. When many plots are being generated and saved on a metafile, the program session should be ended with the 
QU command every 10 to 15 plots. This helps safeguard the results of a lengthy program session in case an error 
occurs that ends the session prematurely (see Operating System Messages and Known Bugs sections on the pre- 
vious page). 

5. Before metafile or data file names are chosen, the DO cmd may be used to list the names of files that already 
exist. This helps avoid writing on files that should not be changed. 

6. The DO cmd may be used to execute programs from within EZPLOT. This allows for new data to be generated 
and plotted during a session. 

7. Several types of help are available in response to the COMMAND? prompt. A ? by itself displays a list and 
brief description of all two-letter plot commands. This list (menu) is also displayed in response to the ME command 
A ? followed by a two-letter plot command displays a more detailed description of that individual command. A ? 
followed by a one-word topic displays all the lines in the list (menu) of plot commands containing that topic. A . 
entered in response to any other prompt displays information relevant to that particular prompt. 

PROGRAM TRANSMITTAL AND IMPLEMENTATION 

The EZPLOT FORTRAN source code and the text of the online user’s guide and help files will be transmitted 
in the following format unless explicit instructions request otherwise. The program will be sent on a nine-track, 
1600 BPI unlabeled tape. The tape will contain ASCII-coded card images. Each card image will be a fixed-length, 
80-character record. Records will be blocked in fixed-length, 800-character blocks. Each block will contain 10 rec- 
ords with no padding. Records wiU not span blocks. The program contains about 10,000 lines of code. The online 
users*s guide and help files together contain about 1000 lines of text. 

DI-3000 source code is not available from the government. GetData source code is available from the govern- 
ment (see ref. 3) but will not be included with the EZPLOT source code. 

EZPLOT was developed and implemented in single prec ision on an ELXSI 6400 32-bit mainframe computer. 
Appendix D contains a brief description of the main program and all subprograms referenced explicitly in 
EZPLOT except DI-3000 subprograms. File assignments ar -. described in appendix E. The FORTRAN code uses 
the FORTRAN 77 Full Language and is ANSI Standard (ref 6) with the following exceptions: statements that use 
system-dependent features and the do i=m,n and end do state ments. 

On the ELXSI computer, EZPLOT executes the system-dependent command cmdstr through the fol- 
lowing subroutine. 


subroutine system (cmdstr) 
character* <*) cmdstr 

CALL $ SETEXITONERROR ( % VAL ( . F ALSE . ) ) 

CALL $SHELL (%STRING (cmdstr (1 : ITRIM(cmdstr) ) ) ) 

CALL $ SETEXITONERROR (% VAL ( .TRUE. ) ) 

CALL $ERRORMSG 

return 

end 

The call to $ SHELL ( ..) causes EMBOS to execute a command. The calls to $S EJEXITON ERROR (...) prevent 
an EMBOS error from terminating EZPLOT executioa The call to $ERRORMSG displays any EMBOS-generated 
error messages. In addition to the call in this subroutine, calls to $SHELL (...) are used throughout the program 
whenever an escape code is sent to the terminal to toggle between text and graphics mode or to clear the screen. 
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The program displays the text of the online user’s guide and help files through calls to subroutine SYSTEM. 
These calls contain the pathname of the requested help file. EZPLOT help files are not in the same format as 
EMBOS help files and may not be listed with the EMBOS help command ( ref. 1). 

The syntax of all system-dependent calls may have to be changed for other host computers. 

Ames Research Center 
Dryden Flight Research Facility 
National Aeronautics and Space Administration 
Edwards, California, February 4, 1987 
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APPENDIX A — EZPLOT SHELLFILE 


This appendix includes the text of the EMBOS shellfile used to prompt for terminal type, select the executable 
module with the appropriate device driver, and initiate execution of the EZPLOT FORTRAN code. 

The string <ESC> is used in this appendix to identify the presence of an escape control character within a string 
of characters transmitted to the terminal. 

- Shellfile to set up for EZPLOT execution. 

parm message +switch default=- 
checkargs 

- Declare shell variables. 

declare ezplotSCR 
declare ezjobID 
declare eztmpID 
declare ezusrID 
declare PlotFile 
declare TermType 
declare UseCommands 
declare slowTek 


- Set usage information and shell variables 

- used to identify working files. 

set ezplotSCR [date +s]" "[time]" "[userlD] 
set ezjobID j[jobID]. 
set eztmpID /Dryden/EZPLOT/temp/ 
set ezusrID EZID. [userlD] 

- Display message if 'message = +' . 
if [message] then 

/embos/ commands/ list /Dryden/EZPLOT/nsg 
end if 

if [var $ BATCH] then 

echo 'EZPLOT version 5.5 (BATCH)' 
timestamp 

set TermType 'BATCH' 

set PlotFile [find $ max=l] 

goto execution 

else 

echo ' <ESC> [ 2 J' 

echo ' <ESC> [ 1 ; 1H<ESC> [ lm<ESC> [ 4m' 

cat 'EZPLOT' [echo ' <ESC> [Orri ] ' Version 5.5' 
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echo ' ' 
timestamp 

label SetTermType 
echo ' ' 

echo 'The following terminals are supported:' 
echo ' ' 

echo ' (T)ektronix 4014/4114' 

echo ' (G)raphon' 

echo ' (S)elanar' 

echo ' (M)odgraph' 

echo ' (4)109 Tektronix' 

echo ' (V) T125' 

echo ' ' 

echo ' Enter your terminal type, or "Q" to quit: (T/G/S/M/4/V/Q) ' 

set TermType (find \$ max=l] 

if (strcmp (TermType] '=' 'G'] then 
set TermType 'GRAPHON' 
goto execution 
end if 

if [strcmp (TermType] '=' 'S'] then 

set TermType ' SELANAR' 
goto execution 
end if 

if [strcmp [TermType] '=' 'M' ] then 

set TermType 'MODGRAPH' 
goto execution 
end if 

if [strcmp [TermType] '=' 'T'] then 
set TermType ' TEKTRONIX' 
set slowTek '+' 
goto execution 
end if 

if [strcmp [TermType] '=' '4'] then 
set TermType '4109' 
goto execution 
end if 

if [strcmp [TermType] '=' 'V'] then 
set TermType 'VT125' 
goto execution 
end if 

if [strcmp [TermType] '=' 'Q'], £ 

[strcmp [TermType] '*»' 'QU'] then 
if [not [var \$BATCH] ] then 
echo ' <ESC> [ 2 J' 
echo ' <ESC> [ 1; 1H' 
end if 
exit 
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end if 

if [strcmp [TermType] '=' 'B'] then 

set TermType 'BATCH' 
goto execution 
end if 

if l strcmp [TermType] '=' 'DEBUG'] then 
set TermType 'DEBUG' 
goto execution 
end if 

if [strcmp [TermType] '=' 'NO COMMANDS'], & 

[strcmp [TermType] '=' 'NOCOMMANDS' ] then 
set UseCommands 'NO' 
echo " 

echo "FILE ' EZPLOT . COMMANDS' WILL NOT BE USED" 

goto SetTermType 

end if 
echo ' ' 

echo ' ILLEGAL INPUT' 
goto SetTermType 
end if 

label execution 

echo 'Setting up for execution...' 
if [strcmp [TermType] '=' '4109'] then 
run /Dryden/EZPLOT/bound/ ezplot . 409 
exit 
end if 

if [strcmp [TermType] '«' 'VT125'] then 
run /Dryden/EZPLOT/bound/ ezplot . 125 
exit 
end if 

run /Dryden/EZPLOT/bound/ezplot . tl4e] 



APPENDIX B — GENERIC DATA INPUT FILES 


A generic data input file contains the following records: 

1. Comment record — This record must appear first and may contain any number of lines of arbitrary text, 
including blank lines. The one exception is that an integer may not appear by itself on a line if more comment lines 
follow (see the following paragraph describing the number of parameters record). Comment lines are optional and 
may be omitted completely. 

2. Number of parameters record — This record contains a single integer on one line. The value of the integer is 
the number of parameters on the hie, up to a maximum of 2000. If there are no comments, this integer appears on 
the first line in the hie. 

3. Name record — This record follows the line giving the number of parameters and c chi tains the parameter 
names, one name for each parameter. Each name may be from 1 to 16 characters long, including leading and 
embedded blanks, which are significant. Trailing blanks and characters beyond the 16th are ignored. Also, each 
name must be enclosed within apostrophes and separated by one or more spaces, a comma, or an end-of-line from 
the other names. 

A line may contain as many names as ht. A name may not be split between two lines. There may be as many 
lines of names as necessary. 

If two or more parameters have the same name and that name is entered as a plot parameter, the first parameter 
with that name in the list of names is plotted. This rule applies even if the same name is entered in response to 
more than one parameter-name prompt. Therefore, it is highly recommended that in any one data input file, each 
parameter name should be different from any other name on that file. 

4. Value record — This record contains the data values and must start on a new line following the name 
record. The data values must correspond one-to-one with the parameter names. Also, there must be the gam* 
number of values for each parameter. Values may be delimited by one or more spaces, a comma, or an end-of- 
line. The data values are grouped into sets of data, each set representing a single data point for each of the pa- 
rameters. Data values may be spread over any number of lines, but each new set of data values must start on a 
new line. 

The following example of a generic data input file declares five parameters and three data points or sets of data. 
The words in parentheses at the end of each line are comments added here for clarity. They are not part of the 
actual file. 


Created on June 20, 1986 by EZPLOT 

5 

'TIME' 'BETA' 'MACH' 

'CANARD' 'ALPHA' 

3443.534 1.00 2.35 -2234.34 12.4 
3467.098, 0.17, 2.66, -4498.23, 8.7, 
3456.656 0.05 2.44 
-3234.55 10.6 


(Comment line) 
(Comment line) 

(Number of parameters) 
(Parameter labels 
enclosed in apostrophies) 
(First set of 5 values) 
(Second set of 5 values) 
(Third set of 5 values) 


There are three ways to create a generic data input file: 

1. data may be entered directly onto a file using a text editor. 



2. a program may be executed that generates a generic dal a file from data already existing in another format; or 

3. the capability built in to EZPLOT for creating or saving generic data may be selected. 

Options (1) and (2) provide for file creation prior to executing E2PLOT. 

Option (3) provides for interactive file creation while EZPLOT is executing. Comments may be entered on a 
generic file only through options (1) and (2). 

Option (3) is implemented by entering the letter “I” in response to the data input file format menu. The pro- 
gram then prompts for the number of parameters to be entered and their names. These names must follow the same 
conventions as given previously in the description of the name record except that they are not enclosed in apos- 
trophes when typed on the keyboard. After the names are entered, the data values may be entered in either of the 
following ways: 

1. enter all data values for one parameter, followed by ail data values for the next parameter, and so on, until 
data values have been entered for all parameters; or 

2. enter the first data value for each parameter, followed by the second data value for each parameter, and 
continue until all the data values have been entered. 

The method of data value entry is selected by entering flora 2. The program then prompts for individual 
data values. 

When data for three or more parameters are being entered, an asterisk (*) may be used in place of a number to 
indicate that a value of l.OE+99 is to be inserted. This large value is not plotted and serves only to fill a location 
when each parameter does not have the same number of legitimate values. 

Data entry may be restarted at any time by entering an s. Data entry is terminated by entering a period. After all 
values have been entered, the data may be saved on a file, may be immediately plotted, or both. This save file may 
be formatted or unformatted. 
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APPENDIX C — PLOT FILE 


An option that allows plots to be written either to the screen or to a plot file other than a metafile is described 
in this appendix. This choice is available in both interactive and batch mode. Information on this plot file may 
subsequently be routed to a laser printer or other suitable device for plotting. 

Interactive Mode 

To use this capability in the interactive mode, begin by setting the value of a shell variable named PlotFile to 
the name of the file that is to receive the plots. For example, if the plots are to be written to file myplots, enter the 
following command line before starting EZPLOT: 

set PlotFile myplots +declare 

Then enter ezplot, followed by the desired plotting commands. The plots do not appear on the screen because the 
coded plotting information normally written to the screen is, instead, written to file myplots. Any previous contents 
of myplots are overwritten. When finished, end the session with a QU command. 

If desired, the plots may now be displayed on the screen by entering the command line 
myplots> copy 

The plot or plots do not remain on the screen. When the end of file is reached, the screen is cleared, and the terminal 
is usually left in its graphics mode rather than its text mode. 

Alternately, if the terminal type was not 4109 or VT125, file myplots may be routed to the Talaris laser printer 
(Talaris Systems Inc., La Jolla, California) for plotting on single sheets of paper. This is most conveniently done 
with the printTalaris command by entering the command line 

printTalaris myplots +Tek 

If some other suitable laser printer or device is available, the plot file may be routed to it for plotting. 

Metafiles cannot be written if PlotFile is used. Conversely, if shell variable PlotFile does not exist in any scope, 
or if its value is .none, or blank (’ ’), the plots are displayed on the screen as usual and metafiles can be written (see 
the Metafiles section). Also, for this case, the program "forgets" PlotFile when the plotting session ends. 

Batch Mode 

To use this capability in batch mode, insert the name of the file to which plots are to be written in the first line 
of the redirected command file in place of the terminal type (see the Redirection and Batch Operation section). For 
example, the following command sequence on file eztm.cmd will write one plot on file myplots. The comments in 
parenthesis are given here for explanation and are not part of the records on the file. 

myplots (name of plot file) 

g (select generic data) 

zgen (name of file containing generic data) 

(standard command, end file name entry) 
y (yes, name is correct) 
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(name of independent parameter) 

(name of dependent parameter) 

(standard command, end parameter name entry) 

(yes, names are correct) 

(draw plot) 

(end execution) 

The job is submitted in batch mode with a command line that looks like 

batch ' eztm. cmd> ezplot' +notify 

If aU plot commands are on file EZPLOT. COMMANDS, the redirected file need only consist of one line containing 
the name of the plot file. If the first line of the redirected command file is blank, contains only one character (a 
terminal type designation), or contains the string .none., the plots go nowhere unless they are saved on a metafile 
with the SA command. Metafiles cannot be written if the first fine contains a file name. If the redirected command 
file is used for interactive plotting (not very commonly done but possible, and occasionally useful), the first line 
must contain the terminal type. 

As for all files created by EZPLOT while running in batch mode, the plot file name is prefixed by the job identifier 
j[jobID). This permits multiple batch jobs to be running in the same directory at the same time. 

AU EZPLOT jobs run in batch mode use the DI3000 tl4e driver. Therefore, the code on file myplots is Tektronics 
4014 code, not 4109 or VT125 code. 

Keep in mind that metafiles are still available, are flexible, and work for aU terminal types. Plots on metafiles 
may be manipulated easily with metafile translators and may lie output to a variety of devices. 


x 

y 

y 

PL 

QU 
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APPENDIX D — PROGRAM CATALOG 


The purpose and general operation of the main program and each of the subprograms in EZPLOT ate briefly 
described in this appendix. Four GetData subprograms and four EMBOS subroutines are also briefly described. 

A list of FORTRAN intrinsics used in EZPLOT is given. Other intrinsics may be used in GetData and DI-3000. 
DI-3000 subprograms are not described here (see ref. 2). 

Main Program 

EZPLOT is the name of the main program that controls overall execution of the statements necessary to generate 
a plot The program begins by setting initial default values including those graphics characteristics that depend on 
the type of terminal being used. Next the data input format to be read and the choice of parameters to be plotted are 
determined. Then any requested input data processing is done followed by scaling calculations. Next, all necessary 
graphics elements such as segments, viewports, windows, and planes are specified; the terminal is set to graphics 
mode; and a plot is drawn. The program then either loops back for the next plot or terminates. 

Subroutines 

AUTOSC (RMlNJtMAXjmCSfLTMIN,PLTMAX) — Subroutine AUTOSC adjusts the minimum and maxi- 
mum value on each axis so that the increment between tick marks is 1, 2, or 5 times 10 to an integer power. 
The calculated range is always greater than the range of the data to be plotted. 

CAPS (STRING) — Subroutine CAPS converts all lowercase characters in STRING to uppercase. 

CFSTAT(XIN, YIN, YFIT, NPTS, COEFFS, FITORD, MEAN, VAR, STDDEV, AVGERR, EZID, TMPID) — Sub- 
routine CFSTAT calculates the mean value, variance, and standard deviation for a polynomial curve fit. 

CURFIT (XIN, YIN, XFIT, YFIT, 1FIT, NPTS, FITORD, COEFFS, MEAN, VAR,S TDDEV^VGERR, TER TYP, 
EZID,TMPID,QUEX ) — Subroutine CURFIT performs a one-dimensional, least-squares polynomial 
curve fit. 

DRAWFI (FITEXTJCFI,YFIJCSIZFI,YS1ZFI) — Subroutine DRAWH draws the figure label. 

DRAWLE (LETEXTJCYL, VU PORT,NC UR VSJCSIZLE,YSIZLE ) — Subroutine DRAWLE draws the y-axis leg- 
end labels. 

DRAWST (XST,YST,OPTLST,ORDERMEAN^VGERR,VAR, STDDEV, COEFFSJCSIZST, YSIZS T ) — Subrou- 
tine DRAWST draws the statistical data. 

DRAWTI (T1TEXTJCTI,YTIJSIZTI,YSIZTI) — Subroutine DRAWTT draws the plot tide. 

DRAWTX (TLINE,TXLOC,TYLOC,TXSIZE,TYSIZE,TPATH,TJUST ) — Subroutine DRAWTX draws a text line. 

DRAWXL (XLTEXTJCXL,YXLJCSIZXL,YS1ZXL ) — Subroutine DRAWXL draws the x-axis labels. 

DRAWYL (YLTEXTJCYL,YYLJCSIZYL,YSIZYL ) — Subroutine DRAWYL draws the y-axis labels. 

ERASER ( ERJ)E£RASEJ)EORRPJ>LXMINJ>LXMAXJ>LYMINJ>LYMAX,TERTYP,GIN,QUEX ) — Subrou- 
tine ERASER marks the relevant area for deleting or replacing points. 

FIGURE (FITEXTfI,TERTYP,QUEX ) — Subroutine FIGURE prompts for the figure label text. 
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FILES (TERTYPf/FILESJNFILEJVEWFILJLMENU,QUEX) — Subroutine FILES prompts for data input file 
names. If there are two or more data input files, the number of curves is set equal to the number of files and 
the names of the files are assigned to the legend line tex . 

FLIGHT(TERTYP, NCURVS, NPTSIN, NFILES, NFILPR , XINDAT, YINDAT, N AVAIL, P, AVAIL, NEWFIL, 

INDPARJ>EPPARJJtTEXTJLTEXT,YLTEXTJ.MENUJNFILEJTIME,TIME,QUEX ) — Subroutine 

FLIGHT retrieves data from flight data input files by ca ling GetData subprograms (see ref. 3). 

GAUSS (A,C,COEFFDfITORD£NGULR ) — Subroutine GAUSS solves n linearly independent equations in 
FTTORD unknowns using Gaussian elimination with p irtial pivoting. This solution is part of the curve fit- 
ting option. 

GENRICfTERTYP, NCURVS, NPTSIN, NFILES, NFILPR, XINDAT, YINDAT, N AVAIL, PAVAIL, NEWFIL, 

INDPARJ)EPPARJJETEXTJCLTEXT,YLTEXTJ,MENUJNFILEf/GPARS,GENDAT,GENLBLJPLOT, 

USERIN.QUEX ) — Subroutine GENRIC retrieves data from generic data input files. 

GETDAT(TERTYPJVDJ)ATTYP,GENDAT,GENLBLfJPTSINS/AVAILJPLOT£ZID,TMPID,QUEX) — Sub- 
routine GETDAT prompts for data input format and provides for inputting generic data from the keyboard. 

GETGEN(GENDAT,GENLBLflPTSINJVCURVSflFILE$J1FILPRJJiTEXT,INDPARJ)EPPAR,TERTYP, 

INFILE J(INDAT,YINDATJ*AVAILflAVAILJCLTEXT, YLTEXTflEWFILJ.MENU,QUEX) Subrou- 
tine GETGEN prompts for parameter names, gets generic data from the data array, and sets default labels, 
including legend label text, where appropriate. 

G INPUT(TER TY P, GEN DATjGENLBLflPTSlNfl AVAIL, ! PLOTJZ ZJD,TMPID,QUEX ) Subroutine GINPUT 
prompts for keyboard entry of generic data, including parameter names and values, and provides for writing 
the entered data on a file. 

GRID (P LX MIN, PLXMAX, NXINTV, XINT, PLYMIN, I LY MAX, NYINTV, YINT, GT, LOGXSC, LOGY SC, 
ABXMINJLBYMIN ) — Subroutine GRID draws a bac kground grid of solid or dotted lines. 

H ELP (USERIN ) — Subroutine HELP displays the reques ed help message. 

HMS (TSECJHRSJMINJSECJMIL ) — Subroutine HMS converts time in total seconds to hours, minutes, 
seconds, and milliseconds. 

JAXES(VXMIN, VXMAX, VYMIN, VYMAX, VXICPT, VYlCPT, NXINTV, NYINTV, IXTIC, IYTIC, IXDRAW, 
IYDRAW) — Subroutine JAXES draws the coordinate axes, including tick marks, assuming that a segment 

is open. 

J LABEL (XMINJCMAX,IXPOS,YMIN,YMAXJYPOSJW'DTHJTEXTJAXLBL, IXLDIRJYLDIR) — Subrou- 
tine JLABEL draws numbers along the coordinate axe i, assuming that a segment is open and that a call has 
been made to subroutine JAXES. 

JLOGAX(VXMIN, VXMAX, VYMIN, VYMAX, VXICPT, VYlCPT, NXINTV, NYINTV, IXTIC, IYTIC, IXDRAW, 

IYDRAW) Subroutine JLOGAX draws logarithmic ally spaced minor tick marics between the major tick 

marks on the designated axis, assuming that a segment is open. 

JLOGLB(XMINJMAXJXPOS,YMIN,YMAXJYPOSJWWTHJTEXTJAXLBLJXLDIRJYLDIRtOGXSC, 

LOGYSC) — Subroutine JLOGLB draws numbers a ong the coordinate axes, including logarithmic axes, 
assuming that a segment is open and that a call has been made to subroutine JLOGAX. 
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LEGEND (XLE.YLE, LETEXT, SY, LI, NCURVS, USERIN, ICOLOR, ISTYLE, ISYMBL, XSIZLE, YSIZLE) — 
Subroutine LEGEND draws legend symbols, lines, and text if those options arc selected and more than one 
curve are plotted. 

LEGLBL (LETEXTL)EPPARJNFILEJVCURVSJVFILES,TERTYP, QUEX) — Subroutine LEGLBL prompts 
for legend label text. 

LINES (LIfiEPPAR JNFILE/ICURVS^f FILES, TERTYP, QUEX) — Subroutine LINES prompts for line visi- 
bility choice. 

MINMAX(NPTS, NCURVS, YMIN, YMAX,XDATA, YD AT A, ABXMIN, ABXMAX, ABYMIN,ABYMAX) - 
Subroutine MINMAX finds the minimum and maximum data for the independent parameter and all depen- 
dent parameters. 11 

MOVAXI(PLXMIN, PLXMAX, PLY MIN, PLY MAX, XINT, YINT, IXTIC, IYTIC, NXINTV, TER TYPJAXLBL, 
GIN, QUEX) — Subroutine MOVAXI prompts for locations used to reposition and resize the coordinate axes. 

MOVLEG (XLE,YLE,TERTYP,GIN,QUEX ) — Subroutine MOVLEG prompts for the location used to reposition 
the upper left-hand comer of the legend. 

MOV ST A (XS T y YS T, TER TYP f GIN ,Q VEX ) — Subroutine MOVSTA prompts for the location used to reposition 
the upper left-hand comer of the statistical data. 

MOVTXT (TEXTXLJEXTYLJTEXTJERTYP, GIN, QUEX) - Subroutine MOVTXT prompts for the location 
of a text line. 

NOSPAC ( STRING ) — Subroutine NOSPAC removes leading and embedded spaces from STRING. 

NUMINT (NXINTV flY INTV^AX LOGXSC LOGY SC ,TERTY P, QUEX ) — Subroutine NUMINT prompts for 
type of, and interval between, tick marks. 

ORDER(N MODE ARRAY JNDEXS ) — Subroutine ORDER sorts ARRAY (a scalar array) containing N real 
numbers into ascending or descending order according to the contents of MODE. The maximum and minimum 
values are isolated at opposite ends of the array while the sort converges toward the middle. The array INDEXS 
holds indexes that indicate the former position of each sorted number. 

PATTXT (ITXPTHJTXJSTJTEXT,TERTYP QUEX ) — Subroutine PATTXT prompts for the path (horizontal or 
vertical) and justification (left or center) of a line of text. 

PLOT (ICURVEJ1PTS,SYLILM, USERIN JCOLOR,ISTYLE,ISYMBLJCSCDAT,YSCDATJ>LXMINLLXMAX, 

PLYMIN JPLYMAX ) — Subroutine PLOT draws a line or symbols, or both, for each dependent variable plot- ' 
ted on multiple y axes. The line or lines, if visible, may have either straight or smoothed (curved) segments. 

PLOTS (NCURVS, NPTSPR, SY, LI, SM, USERIN, ICOLOR, ISTYLE, ISYMBL, XSCDAT, YSCDAT, PLXMIN, 
PLXMAX LLY MIN, PLY MAX ) — Subroutine PLOTS draws a line or symbols, or both, for each depen- 
dent variable plotted on a single y axis. The line or lines, if visible, may have either straight or smoothed 
(curved) segments. 

PRECIS(LPRCSH,TERTYP,QUEX) - Subroutine PRECIS prompts for the desired decimal precision of the 
numbers identifying the tick mark positions along the coordinate axes. 

PROCES (XINDAT, YINDAT, YPRDAT.NPTSIN, NPTSPR, SC, TR, TH, ITHIN, XSCALE, Y SCALE, XTRANS, 
YTRANSLRLOJXC URVS,ERASE J)E ,YM1N, ymaxabxminabxmaxab yminab YMAX L LX MIN, 
PLXM AX LLY MINDLY MAX ) — Subroutine PROCES performs thinning, sorting, scaling, and translation 
and data point replacement. 
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REDUCE ( STRING ) — Subroutine REDUCE left adjusts STRING to eliminate leading spaces and truncates 
(removes) any trailing zeros. 

SAVEPL(TERTYP,SAMETFIL,CALFlL,EZlDflCTITJOK,QUEX) — Subroutine SAVEPL saves the current 
plot as a metafile picture. 

SCALER(XSCALE,YSCALE,INDPAR,DEPPAR, INFILE, \CURVS,N FILES, TERTYP, QUEX ) — Subroutine 
SCALER prompts for a scaling (multiplying) factor. 

SCALEX(NPTSPR, NCURVS, ABXMIN, ABXMAX, XPR1 )AT, XSCDAT, IXLDIR ) — Subroutine SCALEX 
scales the independent parameter values. 

SCALEY (NPTSPR,NCUR VS, YMIN, YMAXABYMINAB YMAX,YPRDAT, YSCDAT^iX,IYLDIR ) — Subrou- 
tine SCALEY scales the dependent parameter values. 

SELECT(LIJSTYLE,SYJSYMBL, TERTYP, QUEX) — Subroutine SELECT prompts for selection of line pat- 
terns and symbol shapes. 

SETFMT (VALUE, WIDTH fMTSTR ) — Subroutine SETFMT formats the display of statistical data. 

SIZLBL(X122JC3J4JCSJC6J7,Y1,Y2,Y3,Y4,Y5,Y6,Y7, TERTYP, QUEX) — Subroutine SIZLBL prompts for 
size of the characters in the labels. 

SIZTXT (TEXTXS,TEXTYS,ITEXT, TERTYP, QUEX) — Subroutine SIZTXT prompts for size of the characters 
in the text lines. 

SMOOTH(SMJ)EPPARJNFILEflCURVSflFILES,TER TYP,QUEX ) — Subroutine SMOOTH prompts for line- 
smoothing choice. 

STATS(ST,OPTLST, TERTYP, QUEX ) — Subroutine STATS prompts for the choice of statistical parameters to 
be displayed. The order of the curve fit along with tire coefficient values, mean value, variance, standard 
deviation, and average error may be displayed. 

SYMBLS (SYJ)EPPARJNFILEJ/CURVSJ1FILES,TER1YP,QUEX) — Subroutine SYMBLS prompts for sym- 
bol visibility choice. 

SYMBOLfLN, NP, XSCPTS, YSCPTS, PLXM1N, PLXMA)\ PLY MIN, PLY MAX ) — Subroutine SYMBOL 
draws a symbol at a data point location. 

SYMSHP (N JPLXMlNfLXM AX JPLY MINDLY MAX) — Subroutine SYMSHP draws various symbol shapes. 
Symbols are individually defined within a 10 x 10 matrix and then scaled to the window size with subroutines 
XSIZE and YSIZE. 

SYSTEM(CMDSTR) — Subroutine SYSTEM execute! the host operating system command contained 
in CMDSTR. 

TERMIN(TERTYP,ICODE ) — Subroutine TERM1N sen Is control sequences to the terminal to select text or 
graphics mode or to clear the screen. 

TEXT (TEXTLNJTEXT, TERTYP, QUEX ) — Subroutine 'I’EXT prompts for the contents of a text line. 

THIN (ITHINJ)EPPARJNFILES/CURVSflFILES,TER TYP,QUEX ) — Subroutine THIN prompts for the per- 
centage of data points to be plotted. 

TITLE (TITEXT,TI, TERTYP, QUEX ) — Subroutine TITLE prompts for the plot title text. 
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TRANSL (XTRANS,YTRANS,INDPARJ)EPPARJNFILEJ1CURVSJ1FILES, TERTYP, QUEX) — Subrou- 
tine TRANSL prompts for a translation (bias) factor. 

UNITS(XSCALE, Y SC ALE, XTRANS, Y TRANS, INDPAR, DEPPAR, INFILE, NCURVS, NFILES, TERTYP, 
QUEX) — Subroutine UNITS prompts for unit conversion factors equivalent to scaling and transla- 
tion combined. 

UPDATE (NCURVS, NCURPR, NFILES, NFILPR, INPUTX, INPUTYJCLTEXT, YLTEXT, LETEXT, INDPAR, 
DEPPAR JNFILEflEWFIL ) — Subroutine UPDATE changes die axis and legend labels and calls for auto- 
matic scaling as necessary when transitioning from the previous plot to the current plot. 

USER (U SERIN, TERTYP, NCURVS, NFILES, INDPAR, DEPPAR, NY AXES, TIME, ERASE, EZID, GIN, AX, 
DE£P£R,FI,GR,GTLELV>FM£C,SM,S0,ST£U£Y,TH,TI,TR,TX,UNXLAXMINAXMAXAYMIN, 

aymaxaxminpaxmaxpayminpaymaxp,ymin,ymax,yminpr,ymaxprj>lxminj>lxmax, 

PLYMIN, PLYMAX, VPXMIN, VPXMAX, VPYMIN, VPYMAX, XLTEXT, YLTEXT, TITEXT, FITEXT, 
LETEXTJ>ICTITtfETFIL,CALFIL,PLTFILXXL,YXL,YLXYL,YYLXTI,YTIXFI,YFIXLE,YLEXST, 
YST, NEWXAB, NEWYAB, XSCALE, Y SCALE, XTRANS, YTRANS, XINT, YINT, NXINTV, NY INTV, 
IXTIC, IYTIC, IAXLBL, IXLDIR, IYLDIR, INFII^, NEWFIL, LOGXSC, LOGY SC, TEXTLN, TEXTXL 
TEXTYL, TEXTXS, TEXTYS, ITXPTH, ITXJST,XSIZXL, YSIZXL,XSIZYL, YSIZYL,XSIZTI, YSIZTI, 
XSIZFI, YSIZFI, XSIZLE, YSIZLE.XSIZST, YSlZST,XSIZNO, YSIZNO,NPTSIN,XINDAT, YINDAT, 
ICOLOR, ISTYLE, ISYMBL, LPRCSN, NPTSPR, XPRDAT, XSCDAT, YPRDAT, YSCDAT, ITHIN, IFIT, 
FITORD, NPTS, COEFFS, MEAN, VAR, STDDEV,AVGERR,OPTLST, QUEX) — Subroutine USER ac 
cepts any valid two-character plot command entered from the keyboard and responds appropriately. System 
commands are accepted as the argument of the DO cmd (see subroutine SYSTEM). 

WAIT(NSECS) — Subroutine WAIT executes a do-nothing loop that causes a program delay of about 
NSECS seconds. 

XLABEL (XLTEXTXL, TERTYP, QUEX ) — Subroutine XLABEL prompts for the jc-axis label text 

XLOGSC (NPTSPRNCURVSABXMINABXMAXXPRDATXSCDATJXLDIR ) — Subroutine XLOGSC scales 
the independent parameter values to fit a logarithmic scale. 

XRANGE (ABXMINABXMAXAXMINPAXMAXP,TERTYP,QUEX) —Subroutine XRANGE prompts for min- 
imum and maximum values for the x axis. 

YLABEL (YLTEXT, YL, TERTYP, QUEX) — Subroutine YLABEL prompts for they-axis label text. 

YLOGSC (NPTSPRf/CURVS,YMIN,YMAXABYMINABYMAX,YPRDAT, YSCDATAXJYLDIR ) — Subrou- 
tine YLOGSC scales the dependent parameter values to fit a logarithmic scale. 

YRANGE(YMIN,YMAX,YMINPR,YMAXPRARYM1NABYMAXAYMINPAYMAXPAXJVCURVSNFILES, 

DEPPAR, IN FILE,TERTYP,QU EX) — Subroutine YRANGE prompts for minimum and maximum values for 
they axis. 

Functions 

BIG — Function BIG returns the real value +1.0E+18. 

IRANGE (IVALJM IN JMAX) — Function IRANGE returns IVAL unchanged if within the range of I MIN and 
IMAX. If outside that range, IVAL takes the value of IMIN or IMAX, depending on which bound 
was exceeded. 
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ITRIM (STRING) — Function ITRIM returns the length of STRING, not including trailing blanks. 

LINDEX (TARGET£EARCH) — Function LINDEX returns the position of the last occurrence of SEARCH 
in TARGET. 

LINT (A) — Function LINT returns the nearest integer less han, or the integer equal to, the real number A. 

NEAR (AfifilAS) — Function NEAR returns a one if MAX (A,B) is zero or if the fraction ABS(A-B)/MAX(A,B) 
is less than BIAS. Otherwise, a zero is returned. 

PRESSR (QUEX) — Function PRESSR displays the prompt Tress <return> to continue ... on the screen and writes 
the string <CR> on unit 9. QUEX contains QU, EX, EE, or a blank. 

RANGE (RVALJRMINJtMAX) — Function RANGE returns RVAL unchanged if within the range of RMIN 
and RMAX. If outside that range, RVAL takes the value of RMIN or RMAX, depending on which bound 

was exceeded. 

READSW (IOBUFF,QUEX) — Function READSW return ; the characters entered in response to a prompt as the 
contents of IOBUFF. QUEX contains QU, EX, EE or a blank. 

SCALE (RVALJtMINJtMAX,SMINJSMAX) — Function SCALE calculates a scaling factor based on the position 
of RVAL relative to RMIN and RMAX in terms of a percentage of the difference between SMIN and SMAX. 

SMALL — Function SMALL returns the real value -l.OE-f 18. 


GetData Subprograms 

The following GetData subprograms are explicitly mentioned in the EZPLOT code. Other GetData subprograms 
inrturf wt in the executable module are not described here. 

CLOSER (UNIT) — Subroutine CLOSER closes a flight duta file. 

FREAD (UNIT, TIME J)ATA) — Function FREAD reads th e next record from a flight data file. UNIT, TIME, and 
DATA are names of variables in GetData. 

OPENR (UNIT JFNAME,NCHS) — Function OPENR opt ns a flight data file and automatically determines the 
file format. UNIT, FNAME, and NCHS are names of v ariables in GetData. 

SIGSR (UNITflAMESflCHS) — Subroutine SIGSR sped lies channels to read by signal name for FREAD. UNIT 
NAMES, and NCHS are names of variables in GetData. 

EMBOS Subroutines 

The following EMBOS system-dependent subroutines are explicitly called from the EZPLOT code. The syntax 
of calls may have to be changed for other host compute rs. 

$ERRORMSG(. ..) — Display any system-generated error messages. 

$SETEXITONERROR(. . J — Set the value of the error exit slag. 

$SHELL(. ..) — Execute a shell command line. 

$VAR(. ..) — Assign the value of a shell variable to a FORTRAN variable. 
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Intrinsics 


The following FORTRAN intrinsics are used in EZPLOT. Additional intrinsics may be used in the DI-3000 and 
GetData code. 

ABS — Absolute value. 

CHAR — Convert integer to character. 

FLOAT — Convert integer to real. 

ICHAR — Convert character to integer. 

INDEX — Position of substring. 

I NT — Convert real to integer by truncating. 

LEN — Length of character expression. 

LOG 10 — Common logarithm. 

MAX — Maximum value. 

MIN — Minimum value. 

MOD — Remainder (modulo). 

NINT — Convert real to integer by rounding. 

SNGL — Convert double precision to single precision. 
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APPENDIX E — FILE ASSIGNMENTS 


EZPLOT assigns the following FORTRAN unit numbers to files which are opened, read, written, and closed at 
various points in the program. While open, these files cannot lie accessed by other EZPLOT jobs. To minimize this 
kind of interference, the names of some of these files are prefixed by a job identifier, symbolized below by the tag 
JljoblDJ. The effect of this identifier is to isolate the file from other EZPLOT jobs. 

Unit 1, /Dryden/EZPLOT/temp/j [jobID].EZPLOT.SCR — This file is used in subroutine CFSTAT to hold sta- 
tistical data for display by subroutine USER when requested. It is also used in subroutine GINPUT to hold 
generic data entered through $stdin until this data is written to a user-named file by EMBOS redirection. 

Unit 2, /Dryden/EZPLOT/usage — This file is accessed in i he main program to record the start time and date of a 
plotting session. It is opened with "appendonly" permission to prevent inadvertent corruption by users. If this 
file happens to be opened by another user, the program will keep trying to access it at about 1-sec intervals 
until successful. 

Unit 3, /Dryden/EZPLOT/temp/j [jobID].EZPLOT.COMM ANDS — This file is accessed in function READSW 
and may contain a list of plotting commands similar to those entered through $stdin. This list of commands 
must initially be on a file named EZPLOT.COMMANDS (unit 4) in the user’s current directory. See command 
SW for more information. 

Unit 4 EZPLOT.COMMANDS — This file may contain a list of plotting commands used to draw a plot. If 
present in the user’s current directory, this file is accessed in subroutine SYSOC and is copied to unit 3 during 
program startup prior to plotting. 

Unit 7 (named by user) — This file is accessed in subroutine FILES and is used to store a list of the names of the 
files that contain data to be plotted. 

Unit 8 (named by user) — This file is accessed in subroutine SAVEPL and contains data in DI-3000 metafile 
format (ref. 5). For jobs run in batch mode, the metafile name is prefixed automatically with thcjfjobIDj. tag. 

Unit 9, /Dryden/EZPLOT/temp/j [jobID].EZID.[userID] - — This file is used throughout the program to store a 
list of all commands and other responses entered through $stdin or EZPLOT.COMMANDS (unit 4). If desired, 
a copy of unit 9 may be saved in the user’s current directory at program completion. If saved, the file will 
be named EZPLOT.U SERIN PUT. For jobs run in batch mode, this name is prefixed automatically with the 
j(joblD). tag. See command SU for more information. 

Units 11 to 18 (named by user) — These files are accessed in either subroutine FLIGHT or subroutine GENRIC 
and contain the data to be plotted. Flight data is read by GetData subroutines. 
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Figure 1. Representative plot showing default axis intervals, dotted grid lines, and various line patterns. 
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Figure 2. Representative plot showing linear and logarithmic scales. 
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Figure 3. Representative plot showing multiple axes. 
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Figure 4. Representative plot showing various symbol shapes. 
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Figure 5. Representative plot showing curve fitting and statistical characteristics of the data. 
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Figure 6. Representative plot showing boxes around points to be deleted or replaced. 
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